home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-6206 / muta / meta.doc next >
Text File  |  1991-06-15  |  5KB  |  124 lines
  1.        New & Improved Metamorph Desk Accessory
  2.  
  3.  
  4. This new version of Metamorphosis has some niceties
  5. that the earlier version did not.  To begin with, it no longer has
  6. the name-length bug(s).  CTL filenames, .3D2 files and output-file
  7. names can be up to 80 characters in length now.  Of course, this
  8. includes ALL characters, including pathnames and extenders.
  9.  
  10. The next (and best) improvement is in the memory usage.  Meta4 only
  11. stores the face-info for the first key-object(s).  This is because
  12. the face-info doesn't change from frame-to-frame, just the vertex
  13. (ie, coordinate) information.  Since objects may have 2X the number of
  14. faces as vertices, this is important.  Especially since each face takes
  15. 8 bytes of storage.  In addition, on bootup Meta4 now "guesses" on how
  16. much memory you wish to reserve for it; it then puts up an alert box
  17. telling you how much it wants to reserve.  It it is too much, click on
  18. the "too much" box and it will decrease the amount by 50K.  MegaST users,
  19. with more memory, will appreciate this feature the most.
  20.  
  21.  
  22. In order to re-use the face info, Meta had to be extensively re-written.
  23. It has also been cleaned up quite a bit, since I took the opportunity to
  24. run the C code thru MWC's compiler to see what it thought of the code.
  25. I found many warning messages and comments on unused variables, so that
  26. is all to the good...should make the program more robust.  It also came out
  27. a lot smaller when compiled under MWC.  The changeover from the fast
  28. floating point to the slower math package in MWC did not make much
  29. difference in overall execution speed.
  30.  
  31. There have been no changes to the control-language, except to add the
  32. keyword END, so that either STOP or END will work.  This is because I
  33. kept trying to use END, and Meta complained.  Computers are picky that
  34. way.
  35.  
  36. The original program was part of an article written for the now-defunct
  37. STart magazine.  I sent them an early version of Meta4 but they never
  38. saw fit to distribute it.  But since the new program is slightly based on
  39. the old, please note the following:
  40.  
  41. "This program is not for resale.  It is NOT in the public domain, although 
  42. you may make as many copies as you wish, as long as this file accompanys
  43. any copy you distribute."
  44.  
  45. While writing the new version, I ran across a very subtle bug which
  46. required a special "hack".  If this program breaks in an unusual way,
  47. please save the control and .3d2 files and send them to me.  I want to
  48. get to the bottom of the problem, but it's a difficult one (I can't tell
  49. if it is a OS bug, CAD-3D bug or mine!).  This bug, although I seem to
  50. have squashed it, seems to be associated with rainbow TOS.
  51.  
  52.  
  53. Mark Kimball 6/15/91
  54.  
  55.  
  56.             APPENDIX
  57.  
  58. Here's a recap of the commands that Meta4 understands, plus an example
  59. of a control file.  NOTE Meta4 is case-sensitive!
  60.  
  61.     frames    usage example:  15 frames
  62.  
  63.     load      example:      load bird00.3d2
  64.  
  65.     begin      example:      begin birdani
  66.  
  67.     doit      usage:      doit  (only usage)
  68.  
  69.     stop      usage:      stop
  70.  
  71.     end      usage:      end (does the same thing as STOP).
  72.  
  73.  
  74. Here's an example of a control file.  It shows how you can load several
  75. files, do a metamorphic animation on them, and then load some more, etc.
  76.  
  77. load w1.3d2
  78. load w2.3d2
  79. load w3.3d2
  80. 10 frames
  81. begin wtest
  82. doit
  83. load w3.3d2
  84. load w2.3d2
  85. load w1.3d2
  86. 15 frames
  87. doit
  88. stop
  89.  
  90.  
  91. NOTES
  92.  
  93. You cannot include comments in the control file; this will confuse
  94. the interpreter.  Blank lines are OK.
  95.  
  96. Don't include a file extender for the output file-name following "begin".
  97. Meta4 will do it for you.
  98.  
  99. Metamorphed objects in the .3d2 files must share common names as well
  100. as common face structures.  Here's an example of what I mean:
  101.  
  102. First 3d2 file contains:  "bird","ball" and "dog".
  103. All subsequent files, up to a "doit" command, MUST contain these 3
  104. objects.  Each object in each file must share a common ancestry.  In
  105. other words, you can't use a cube named "cube" in the first file and
  106. a sphere named "cube" in the next file.  Meta4 compares the face-structure
  107. of all similarly-named objects and complains if they don't match.  So, the
  108. objects can be mashed, squeezed, scaled, rotated or moved, but they
  109. have to be topologically equivalent.  Meta4 is too stupid to use any other
  110. type of object.  Anyway, using the same name in subsequent files makes
  111. it a LOT easier to create key-frames in CAD-3D.
  112.  
  113. After a "doit" command, you can start over again with object names, so
  114. the next set of loads can contain, for example, just "bird" and "dog".
  115.  
  116. CyberSculpt sometimes will alter face-structures if objects are
  117. distorted too much.  The magnet tool seems to be especially bad for
  118. this.  So you may have to experiment to see what works and what doesn't.
  119.  
  120. Good Luck!  Happy Animating!
  121.  
  122. Mark K.
  123.  
  124.